home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / VIEWERS / MSDOS / SHWGIF51.ZIP / SHOWGIF.DOC < prev    next >
Text File  |  1990-11-25  |  33KB  |  1,057 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.              ////////  //                        /////  ////    //////
  9.            //        //                        //       //    //
  10.          ///////   /////    ////   //    //  //   //  //    /////
  11.             //   //   // //   // // // //  //   //  //    //
  12.      ///////   //   //   ////    //////  ///////  ////  //
  13.  
  14.                                   Version 5.1
  15.  
  16.  
  17.                                    Written By
  18.  
  19.  
  20.                                   Bill Parquet
  21.  
  22.                                       and
  23.  
  24.                                  Dave Sharpless
  25.  
  26.  
  27.                               Copyright July, 1990
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                                           Introduction
  74.          -------------------------------------------------------------
  75.  
  76.               How often have you downloaded a GIF file from your
  77.          favorite BBS only to discover you wasted maybe 15 minutes and
  78.          50,000 bytes of download credits on an array of dots that
  79.          doesn't deserve to be called a picture, or had a "bad code in
  80.          file" after the first 10 lines?  Wouldn't it be better to see
  81.          the picture as you are getting it?  Just abort the transfer,
  82.          saving your time and credits for something more worthwhile if
  83.          you don't like it?  If so, SHOWGIF is just the program for
  84.          you!  It is a TSR that quietly waits for the system to begin
  85.          writing a GIF file.  Once writing begins, SHOWGIF switches to
  86.          the appropriate VGA or EGA video mode, and shows the picture
  87.          as it is coming over.  Unlike other view it while you get it
  88.          setups, it works with nearly ALL protocols available.
  89.  
  90.  
  91.                                                    System Requirements
  92.          -------------------------------------------------------------
  93.  
  94.               For SHOWGIF to operate properly, your system must be
  95.          equipped with an EGA, VGA, or Super-VGA video card.  It also
  96.          requires about 32k of memory (mostly for GIF decoding).
  97.  
  98.  
  99.                                                    Configuring ShowGIF
  100.          -------------------------------------------------------------
  101.  
  102.               The first step in operating ShowGIF is the setup.
  103.          Configuring ShowGIF is a simple process.  The first thing to
  104.          do in this process is to select a setup file which best
  105.          matches your card.  Each of these files has the extension
  106.          CNF.  The first line of each of these files contains the name
  107.          of card that it corresponds to.  Pick out the one which best
  108.          matches your video setup.
  109.  
  110.               Once you have selected the setup file for your system,
  111.          run CSHOWGIF followed by the name of the name of the file
  112.          that you have selected.  For example "CSHOWGIF VGA.CFG"
  113.          CSHOWGIF will print out the current setup and load in the new
  114.          setup.  It will inform you if you are using an unsupported
  115.          bank switching method or if a resolution is unlikely.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.               The final phase of the setup involves series of
  140.          questions relating to how the operation of ShowGIF.  Most of
  141.          these options can be altered with the use of command line
  142.          options, but are also available here for convenience.  The
  143.          first question refers to the message delay.  It is the amount
  144.          of time (in 0.054 second clock cycles) that the result of the
  145.          view remains on the screen before returning to the original
  146.          display.  Normally it is 36, or about 2 seconds.  You MUST
  147.          enter a number here (the original setting given for
  148.          reference).  Next you're asked if you want to enable or
  149.          disable stream and extension detection methods.  If you hit
  150.          enter for either of these, than the existing setting will be
  151.          used.  The implications of each will be discussed later.
  152.          (NOTE: CSHOWGIF will not let you turn both methods off
  153.          because ShowGIF would not have any way to detect a GIF file).
  154.          Finally it asks if you wish ShowGIF to pause after the
  155.          display.  This is probably best left off.  If enabled,
  156.          ShowGIF will wait for a key before removing the picture.
  157.          Like before, enter will keep the existing setting.
  158.  
  159.               The next changes are optional.  CSHOWGIF will ask you if
  160.          you wish to redefine the keys.  Enter or 'N' will skip this
  161.          phase.  If you do wish to change the ShowGIF keys, hit 'Y'.
  162.          It will then ask you that key to hit for aborting the view
  163.          (normally BACKSPACE).  Press the key that you wish to use.
  164.          Next, it will ask you the key to use for blanking the screen
  165.          (normally TAB).  Press the key that you wish to use.  Shift
  166.          key sequences aren't recognized by either prompt, meaning
  167.          CTRL C will be the same as SHIFT C, ALT C and C by itself.
  168.          CSHOWGIF will not stop you from setting both functions to the
  169.          same key, but you setting it as such will disable the screen
  170.          blanker.  NOTE: If you do reconfigure the keys, make sure
  171.          they aren't keys that your protocol uses.  These may included
  172.          keys such as ESC, CTRL-C, CTRL-X.  ShowGIF will trap these
  173.          keys and prevent you from aborting your transfer.  When you
  174.          have finished, a reconfigured copy of ShowGIF will be written
  175.          to disk.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                                 Operation Instructions
  206.          -------------------------------------------------------------
  207.  
  208.  
  209.               Once you have ShowGIF configured, all you need do is
  210.          type "SHOWGIF" before you load your favorite terminal program
  211.          and it will be ready to use.  Once you begin downloading a
  212.          GIF file, or an archive that contains GIF files, ShowGIF will
  213.          start, and begin displaying the data as it goes to disk.
  214.          ShowGIF may not start immediately, as it must wait until it
  215.          has collected enough information about the picture to begin
  216.          drawing.  It will usually "kick in" after the second
  217.          Ymodem/Zmodem block.  If anything goes wrong during the
  218.          transfer, ShowGIF will abort and give you a message
  219.          explaining what happened.  If the transfer goes successfully,
  220.          ShowGIF will finish with a "view successful" message.  After
  221.          you finishing your session in the terminal program and return
  222.          to DOS, type "SHOWGIF /u" to remove ShowGIF from memory.
  223.  
  224.  
  225.                                                            Batch Files
  226.          -------------------------------------------------------------
  227.  
  228.  
  229.               We recommend that you create that (if you haven't
  230.          already) you create a batch file that loads ShowGIF, loads
  231.          your terminal program, then unloads ShowGIF.  This prevents
  232.          ShowGIF from occupying memory any longer than it has to, and
  233.          it helps to prevent the side effects mentioned later.  If you
  234.          plan to use ShowGIF in immediate mode, another batch file
  235.          should be created.  It should enact the setup for immediate
  236.          viewing and pass the file you wish to view.  There will be
  237.          much less hassle with command-line switches and accidental
  238.          installations.
  239.  
  240.               Here are a few sample batch files:
  241.  
  242.          @echo off
  243.          showgif
  244.          e:\modem\qmodem.42\qmodem
  245.          showgif /u
  246.  
  247.          @echo off
  248.          showgif /p:+ /d:1 %1
  249.  
  250.               The first one installs ShowGIF, runs a terminal program,
  251.          then uninstalls.  The second uses ShowGIF's immediate mode to
  252.          view a given GIF file with pausing on, then exits.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                                  ShowGIF function keys
  272.          -------------------------------------------------------------
  273.  
  274.  
  275.               When active, ShowGIF allows you to perform two
  276.          functions.  (This includes both immediate mode and during
  277.          file transfers) The first function is "Abort-View" It aborts
  278.          the ShowGIF file viewer, but not the transfer itself.  I
  279.          don't see any practical use for this other than in immediate
  280.          mode when you've "seen enough of the picture." During a
  281.          download, you can just abort the transfer itself and ShowGIF
  282.          will abort with it.
  283.  
  284.               The second function is an "on-demand" screen blanker.
  285.          Its there to prevent those particularly embarrassing moments
  286.          when your spouse walks into the room and happens to notice
  287.          that you are downloading that new X-Rated picture.  Despite
  288.          that there is nothing on the screen, the download and view
  289.          will progress normally.  Any subsequent keypress will unblank
  290.          the screen.  The screen will automatically un-blank when
  291.          ShowGif finishes (ie at end of transfer or if an error
  292.          occurs).
  293.  
  294.               The default settings are backspace for abort view and
  295.          tab for blank screen.  You may change these with CSHOWGIF.
  296.          Note that, Shift/Ctrl/Alt shift key combinations are NOT
  297.          recognized!  (ie  Shift-X, Alt-X, Ctrl-X, and X are all the
  298.          same).  ALSO NOTE: do not choose combinations that your
  299.          protocol uses for its functions.  For example, if you're
  300.          protocol uses Ctrl-C to abort the transfer, don't set blank-
  301.          screen to C.
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.                                                      How ShowGIF Works
  338.          -------------------------------------------------------------
  339.  
  340.                           *** General Description ***
  341.  
  342.               DOS contains several services for opening, closing,
  343.          writing to files.  ShowGIF positions itself between the
  344.          application program (usually your terminal program or
  345.          external protocol) and the DOS.  In this position it
  346.          intercepts calls to DOS, checks to see if they are of any
  347.          importance, then passes them along to DOS unaltered.  This
  348.          sounds dangerous and destructive but, in this situation, it
  349.          is beneficial.
  350.  
  351.               ShowGIF can be in one of two states when it intercepts
  352.          these DOS calls.  The first state is where it monitors all
  353.          the open and write calls.  If one of these calls implies that
  354.          a GIF file is going to disk, ShowGIF makes note of this file
  355.          and switches to the second state.  In the second state,
  356.          ShowGIF monitors write and close calls.  If the write is to
  357.          go to aforementioned file, ShowGIF intercepts the data and
  358.          decodes it to the screen.  If it sees that the application is
  359.          going to close the file one of two things happens.  It will
  360.          either print "View Successful" or "Transfer Aborted or File
  361.          Incomplete" depending on whether the decoder finished and
  362.          switched back to the monitoring state.
  363.  
  364.               All this happens unbeknownst to the file transfer
  365.          software.  The software assumes that it is performing normal
  366.          opens, writes, and closes.  The upshot of this is that
  367.          downloads with ShowGIF and downloads without ShowGIF are
  368.          identical, or nearly so.
  369.  
  370.                            *** Modes of Detection ***
  371.  
  372.           In ShowGIF 5.1, unlike previous versions, there are two
  373.          ways in which a GIF file can be detected.  They are:
  374.  
  375.  
  376.                       - Detection by Filename-Extension -
  377.  
  378.               This is the original method of detecting GIF files.  If
  379.          a file opens with the GIF extension, ShowGIF will start and
  380.          begin decoding.  The advantages to this method are that it is
  381.          very simple and quick.  The disadvantages to it are that it
  382.          will not detect a GIF file when the picture in circumstances
  383.          such as when the protocol uses a temporary name than does not
  384.          have the GIF extension (as in Procomm Plus and SeaLink) or
  385.          when the GIF file is in an archive (a common practice among
  386.          misinformed people).
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                          - Detection by File Streams -
  404.  
  405.               Detection by file streams works by monitoring the output
  406.          to all the open files, and checking this output for the
  407.          presence of the keyword "GIF87a."  This will detect a GIF
  408.          file with any name and even if its part of another file (such
  409.          as stored in a ZIP file).  Unfortunately, this method may
  410.          slow down drive access (although not noticeably) and may
  411.          cause it to start unnecessarily.  (For instance, it would
  412.          believe this text file is a GIF because of the header string
  413.          listed above).
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                                   Command Line Options
  420.          -------------------------------------------------------------
  421.  
  422.  
  423.               /u   :  Uninstalls ShowGIF.  This returns all the memory
  424.                       used by ShowGIF and restores the system vectors
  425.                       tapped by ShowGIF.  The Uninstall routine was
  426.                       repaired somewhat, but if it still causes
  427.                       trouble,  MARK & RELEASE can be used
  428.                       successfully.  A word of warning to the wise:
  429.                       If you install ShowGIF and install another TSR,
  430.                       then uninstall ShowGIF, memory will become
  431.                       fragmented (not unlike fragmentation on your
  432.                       hard drive) and your computer will probably lock
  433.                       up the next time you load a program.
  434.  
  435.               /e+
  436.               /e-  :  Enables or Disables detection of GIF files by
  437.                       the extension of their filename.  These switches
  438.                       can override the setting made during
  439.                       setup.
  440.  
  441.               /s+
  442.               /s-  :  Enables or Disables detection of GIF files by
  443.                       the contents of the file output streams.  These
  444.                       switches can override the setting made during
  445.                       setup.
  446.  
  447.               /p+
  448.               /p-  :  Forces or prevents ShowGIF from waiting for a
  449.                       keystroke after displaying the picture.  This
  450.                       allows you to admire the picture for a little
  451.                       bit after drawing is complete.  This will
  452.                       override any setting made in setup.  You may
  453.                       want to enable this feature for viewing GIFs in
  454.                       immediate mode:  "SHOWGIF /p:+ KYM256.GIF" or if
  455.                       you use ShowGIF for viewing GIF files.
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.               /d:xx:  Sets a delay for the result to remain on the
  470.                       screen after viewing is complete.  xx may range
  471.                       from 1 to 255, and is proportional to the number
  472.                       of seconds (divide by 18.2)
  473.  
  474.  
  475.  
  476.               /b   :  Disable BIOS video trapping.  I put BIOS
  477.                       trapping in on a bit of a whim and I'm not
  478.                       absolutely sure of the consequences of what I've
  479.                       done.  Nothing should go wrong, BUT if something
  480.                       does I've included this switch.
  481.  
  482.               'File': Displays a certain file then exits. (Immediate
  483.                       mode).  You may wish to use the /p:+ switch
  484.                       with this command.  An example would be "SHOWGIF
  485.                       BALLONS.GIF"  [sic] in which showgif would
  486.                       merely display that picture then exit.
  487.  
  488.               /h   :  Displays a help screen listing all the commands
  489.                       (except /b)
  490.  
  491.  
  492.                                                       ShowGIF messages
  493.          -------------------------------------------------------------
  494.  
  495.  
  496.                            *** Run-Time messages ***
  497.  
  498.          "Bad Code In File"  Usually means that the picture data is in
  499.          some way garbled.  For those interested, it means that
  500.          ShowGIF encountered a Zev-Lempel code that exceeded the
  501.          acceptable range.
  502.  
  503.          "Damaged parameter block"  ShowGIF found that the screen
  504.          resolution request was unreasonable (ie 320 ≤ x-resoution ≤
  505.          1280 and 200 ≤ y-resolution ≤ 1024) or the local picture size
  506.          is larger than the requested resolution.  This usually
  507.          indicates that the text 'GIF87a' was encountered in a text
  508.          file.
  509.  
  510.          "Not a GIF file"  A file with the GIF extension was created,
  511.          but the first 6 characters don't match the GIF header I.D.
  512.          Its possible that somebody renamed a file of a different type
  513.          to GIF just to annoy you!
  514.  
  515.          "Incomplete picture"  This message usually occurs when you
  516.          abort the transfer, but it also might occur because the
  517.          person who uploaded the picture aborted and the BBS didn't
  518.          delete the file.  The worst part is there is no way to detect
  519.          these until they happen.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.          "Transfer aborted or GIF incomplete"  The defined abort key
  536.          was pressed and ShowGIF has returned to protocol's text
  537.          screen.
  538.  
  539.          "View Successful"  The picture passed through ShowGIF without
  540.          any flaws.
  541.  
  542.  
  543.                          *** Installation Messages ***
  544.  
  545.  
  546.          "ShowGIF:  Already Installed"  ShowGIF is already ready to
  547.          use and won't let you install it twice.
  548.  
  549.          "ShowGIF:  /u requires that ShowGIF be installed"  ShowGIF
  550.          cannot find its resident portion.
  551.  
  552.          "ShowGIF:  Cannot open immediate file"  You've started
  553.          ShowGIF with an immediate filename that it cannot locate.
  554.  
  555.          "ShowGIF:  Both detection methods are disabled, aborting
  556.          installation"  You've attempted to run ShowGIF with no way to
  557.          detect a GIF file, so it would just sit in memory uselessly.
  558.          You must use /e:+ and/or /s:+ to provide a means for
  559.          detection.
  560.  
  561.          "ShowGIF:  Invalid switch"  Use ShowGIF /h to list the valid
  562.          switches.
  563.  
  564.          "ShowGIF:  Uninstalled"  This just informs you that ShowGIF
  565.          has been successfully Uninstalled and memory freed.
  566.  
  567.                                                                 Quirks
  568.          -------------------------------------------------------------
  569.  
  570.  
  571.               Most quirks are due to ShowGIF's sensitivity to the
  572.          creation of a GIF file alone and not its origin.  For
  573.          instance, COPYing a GIF file around also will kick in the
  574.          viewer.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                                            Answers to common questions
  602.          -------------------------------------------------------------
  603.  
  604.  
  605.          I'm using showgif in immediate mode.  The picture comes up
  606.          quickly then disappears.  Is there any way to make it pause
  607.          at the end?
  608.  
  609.          Yes:  Use the command line /p:+ or turn pausing on in the
  610.          setup.  Note that if you turn it on in the setup, you may
  611.          want it off in regular use, or else the screen will pause at
  612.          the end of a download!
  613.  
  614.          ------------------------------------------------------------
  615.  
  616.          Why won't ShowGIF sense when I'm downloading a GIF file?
  617.  
  618.          **Procomm Plus users will experience the problem.
  619.      Fortunately, ShowGIF 5.1 addresses this issue with stream
  620.          detection. To use stream detection give /s:+ command line or
  621.          the change the setup.  What usually happens is that the
  622.          terminal (or protocol driver) makes a temporary file of some
  623.          sort to be renamed after the transfer.  This file usually
  624.          doesn't have the GIF extension.  Stream detection looks at
  625.          the file contents instead of the extension.
  626.  
  627.          -------------------------------------------------------------
  628.  
  629.  
  630.          Why does showgif wait a very long period of time before
  631.          starting, and operate in widely spaced bursts?
  632.  
  633.          Users of **Telix's built in Zmodem may experience this
  634.          problem.  Telix's sending its output to disk in large bursts
  635.          causes this problem.  Since ShowGIF operates off these disk-
  636.          writes (not modem accesses), your problem occurs.  The best
  637.          solution to this problem is to disable buffering.  If you're
  638.          using a hard drive to download, the write time for each block
  639.          is negligible.  If you cannot disable buffering, your other
  640.          options are to use a different protocol or an external
  641.          protocol driver, or just not let it get to you.
  642.  
  643.          ------------------------------------------------------------
  644.  
  645.          Why does ShowGIF activate then deactivate with an incomplete
  646.          message, then reactivate?
  647.  
  648.          **Qmodem users have this problem, as Qmodem  opens then
  649.          closes the file, then reopens it.  Either disable extension
  650.          detection (and enable stream detection) /e:-/s:+ or just
  651.          ignore it.  It is harmless.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.          Why does a lockup often follow uninstallation of ShowGIF?
  668.  
  669.          The most probable cause of this is installing something on
  670.          top of ShowGIF.  Here is what happens, you install ShowGIF,
  671.          then you (mistakenly) install another TSR.  After you
  672.          finish, you uninstall ShowGIF with the /u switch.  Now there
  673.          is a 32k unused 'hole' in your used memory.  Next thing you
  674.          know, a different program tries to fit 200k of data into that
  675.          32k hole.  Since this data doesn't fit, it over-writes your
  676.          TSR in memory.  Nothing seems wrong until you try to activate
  677.          this now nonexistent TSR...
  678.  
  679.          ------------------------------------------------------------
  680.  
  681.          I have a few unusually sized pictures . . .
  682.  
  683.          . . .And ShowGIF won't view them because it looks at the GIF
  684.          header and checks to see if the information is feasible.
  685.          Horizontal resolution must be between 320 and 1024.  Vertical
  686.          resolution must be between 200 and 1024, among other things.
  687.          I implemented this extended checking to protect the stream
  688.          detection against text files that mention 'GIF87a' or the
  689.          like.  There is no solution to this problem.
  690.  
  691.          -------------------------------------------------------------
  692.  
  693.          Why won't ShowGIF use the whole screen on my Video 7
  694.          Fastwrite?
  695.  
  696.          Try issuing the /b command line switch to disable Video Bios
  697.          interception.  This is the only case I can think of where
  698.          this switch may become necessary.
  699.  
  700.          ------------------------------------------------------------
  701.  
  702.          ShowGIF wraps the picture around several times in the middle
  703.          of the screen or Showgif gets past the first quarter of the
  704.          screen and locks up.
  705.  
  706.          Recheck which configuration file you are using.  The plane
  707.          switching method probably isn't correct, or you are using an
  708.          unsupported plane switching technique.  Valid techniques are
  709.          "NONE" "TSENG" "VIDEO7" "TRIDENT" "PARADISE" "CHIPSNTECH"
  710.          and "ATI."
  711.  
  712.          -------------------------------------------------------------
  713.  
  714.          My monitor goes nuts when viewing certain large pictures.
  715.  
  716.          Your monitor may not handle the resolution that your card is
  717.          using.  Remove the highest resolution from your current
  718.          configure file, and try again.
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.          What can I do about ShowGIF significantly slowing down my
  734.          file transfer?
  735.  
  736.          Use a different protocol or a different driver.  The one
  737.          that you are currently using depends on completion of drive
  738.          accesses before proceeding with the transfer.  Since ShowGIF
  739.          "slows down" these transfers, poorly constructed protocols
  740.          may suffer.
  741.  
  742.          ------------------------------------------------------------
  743.  
  744.          I'm concerned that ShowGIF will interfere with the transfer
  745.          itself.
  746.  
  747.          There is no reason to worry about ShowGIF interfering with
  748.          the transfers themselves.  ShowGIF operates transparently
  749.          with most protocols.  The only noticeable effect (for the
  750.          protocol) is that drive access will be noticeably slower (as
  751.          ShowGIF is both "un-GIFfing" the data and writing it to the
  752.          drive).  If the protocol uses interrupt driven I/O properly,
  753.          no loss of speed will occur.  Because ShowGIF operates with
  754.          the streams of data going to the disk, NOT the streams of
  755.          data coming from the modem, protocol reliability is not
  756.          affected.
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.                                                     Update Information
  800.          -------------------------------------------------------------
  801.  
  802.  
  803.          1.0 α: First version of SHOWGIF <Not released>
  804.  
  805.               * Converted from a standalone gif decoder into a
  806.                 decoder/viewer then into a TSR.
  807.  
  808.          1.0 ß: Several features added:  <Not released>
  809.  
  810.               * Status report at the end of viewing (Not a gif, bad
  811.                      code, etc.)
  812.               * Support for ATI, TSENG chipsets, separate versions of
  813.                      the program
  814.               * Switch back normal video if d/l is aborted before
  815.                      viewer is aborted.
  816.               * Squeezing pictures to fit 320x200 (MCGA version)
  817.  
  818.          2.0  : Several problems fixed: <Beta Test>
  819.  
  820.               * Code parsing routine completely re-written for speed
  821.               * Rest of the main loop translated into machine language
  822.               * Lockup after "Picture is not a GIF" message resolved
  823.               * Picture information put up while drawing
  824.               * Stack frame is normalized after each picture -- no
  825.                      more lockup's after viewing 'too many' pictures
  826.               * 500% overall increase in speed! (benchmark 20 seconds
  827.                    in 1.0 to 4 seconds in 2.0)
  828.  
  829.          3.0  : Improvements made <Beta Test>
  830.  
  831.               * Support for EGA
  832.               * X axis scaling for pictures larger than 320 MCGA,EGA
  833.  
  834.          3.5  : Improvements made <First release>
  835.  
  836.               * One program can handle various video cards
  837.               * Internal configuration for video hardware
  838.               * Support for 10 more video cards
  839.  
  840.          3.7  : Improvements made <Beta Test>
  841.  
  842.               * 16 color (EGA) modes supported in standard VGA
  843.                    configuration (640x350 and 640x480)
  844.               * Offset picture difficulties corrected.
  845.  
  846.          4.1  : Improvements made <Rare Second release>
  847.  
  848.               * User definable resolutions (compatible with VPIC)
  849.               * Better judgement is used when choosing video modes.
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.          4.1B : Cosmetic changes <Preferred second release>
  866.  
  867.               * Mistake in "VGA.CFG" corrected (oops!)
  868.               * Thought I fixed the "text at the bottom of the screen
  869.                 problem" but it still didn't work.
  870.  
  871.          5.0  : A hack
  872.               Version 5.0 is NOT a valid release.  If you have a
  873.               version 5.0 it <MAY> have a virus and should be deleted
  874.               IMMEDIATELY
  875.  
  876.          5.1  : Many Improvements made <Third release>
  877.  
  878.               * Opening screen
  879.               * EGA routines GREATLY improved -- 3x's improvement in
  880.                 speed
  881.               * Initialization translated into ml (except EGA color
  882.                 selection) for compactness & control
  883.               * Various sections carefully optimized for a 50%
  884.                 increase in speed for VGA.
  885.               * EGA screen output GREATLY improved for about 250%
  886.                 improvement in speed overall.
  887.               * Bug with viewing certain pictures which are
  888.                 interlaced/smashed in EGA mode corrected
  889.               * File stream detection added.
  890.               * Checks the GIF header for information feasibility.
  891.               * Immediate mode GIF viewing.
  892.               * Control over the delay after viewing.
  893.               * Optional press a key pause after picture display.
  894.               * Bios video functions disabled during view.
  895.                 (Note: if this causes problems, it can be disabled
  896.                  with the /b switch)
  897.               * More extensive command line options.
  898.               * Bug with uninstall corrected (I think!)
  899.               * Problems with memory allocation fixed (Doesn't take
  900.                 any more memory then it really needs -- only about
  901.                 30k)
  902.               * Abort-view key made more responsive (though I don't
  903.                 really see a need for using it)
  904.               * On-demand screen blanker added.
  905.               * Ability to redefine the control keys.
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.                                                       Shareware notice
  932.          -------------------------------------------------------------
  933.  
  934.  
  935.               The registration fee for ShowGIF is $30.  For this we
  936.          will give you:
  937.  
  938.               1)  A registered ShowGIF on 5 1/4 floppy (unless
  939.                   otherwise specified) with Super-VGA support, and the
  940.                   lengthy title screen removed.
  941.  
  942.               2)  A lovely printed version of the documentation.
  943.  
  944.               3)  Notice of future updates.
  945.  
  946.  
  947.  
  948.          If you wish to contact me, Call The Henrietta Outhouse
  949.          (216/965-5463) or my board (419/531-2693 9p-9a weekdays only)
  950.               BILL PARQUET
  951.               30231 BATES RD.
  952.               PERRYSBURG, OHIO  43551-3827
  953.  
  954.  
  955.                                                       Software Credits
  956.          -------------------------------------------------------------
  957.  
  958.  
  959.               I will give credit for all the software that I have
  960.          mentioned throughout this document.
  961.  
  962.  
  963.          **VPIC is a first rate picture file viewer (if you ignore all
  964.          the bugs).  2.9 is the newest version at the time of this
  965.          writing.  VPIC may be obtained from:
  966.               BOB MONTGOMERY
  967.               132 PARSONS RD
  968.               LONGWOOD FL  32779
  969.  
  970.          **GIF is a trademark of Compuserve, an H&R Block company.
  971.  
  972.          **Qmodem may be the best communications program in existence.
  973.          4.2 is the newest version at the time of this writing.
  974.          Qmodem can be obtained from:
  975.               THE FORBIN PROJECT, INC.
  976.               POST OFFICE BOX 702
  977.               CEDAR FALLS, IA  50613
  978.  
  979.          **Procomm Plus is a terminal package made by:
  980.               DATASTORM TECHNOLOGIES, INC
  981.               POST OFFICE BOX 1471
  982.               COLUMBIA, MO  65205
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.          **Telix is terminal package made by:
  998.               EXIS, INC
  999.               POST OFFICE BOX 130
  1000.               WEST HILL, ONTARIO
  1001.               M1E R4
  1002.  
  1003.          **Mark & Release are TSR management programs and are
  1004.          copyrighted by Turbo-Power software:
  1005.               TURBO-POWER SOFTWARE
  1006.               POST OFFICE BOX 66747
  1007.               SCOTTS VALLEY, CA  95066-0757
  1008.  
  1009.  
  1010.  
  1011.                                                                  Kudos
  1012.          -------------------------------------------------------------
  1013.  
  1014.               I'd like to think a few people, without which, ShowGIF
  1015.          would be far less complete.
  1016.  
  1017.  
  1018.          Dave Sharpless:  For programming the plane switching
  1019.          routines, entering the large amount of card information in
  1020.          the first release.  Writing the intro for release 4.1 and the
  1021.          intro for future release 5.5 or 6.0 (the intro is done, now
  1022.          all I have to do is write the program!) and urging that I
  1023.          charge a fee for this.
  1024.  
  1025.          John Sharpless:  Sysop of the Henrietta Outhouse III,  For
  1026.          bringing ShowGIF's success & distribution.  ShowGIF would
  1027.          probably only be used by the three of us and a couple people
  1028.          in Toledo if it weren't for him.
  1029.  
  1030.                           Thank you for using ShowGIF!
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.